Shareware Grab Bag/Shareware Grab Bag.iso/017/ebl306b.arc/BATDOC.BAT

DOS Batch File | 1986-11-06 | 18KB | 472 lines

bat /p * Loading HELP and DOCUMENTATION ..... (Non-IBM systems, read NOTE below)

*           Written by F.Canova 10/5/83 through 07/7/86
*   (c) Copyright 1983, 1985, 1986 by Seaware Corp. all rights reserved.
*    This batch file REQUIRES EBL Version 3 for proper execution!

         **** NOTE! NOTE! NOTE! NOTE! ****
 RAM    |* <-----Change 'RAM' to 'BIOS' if PC isn't 100% IBM Compatible!

 if %G = .goto. then %G = | goto -%F
 else goto -line0


-header * Routine prints general purpose header for help text
    stack.purge            |*  remove any pre-typed keystrokes.
    %n = %i $ 1 ( %i # - 2 ) & . & ( %i $ ( %i # - 1 ) 2 ) |* extract section # from page #
    cls begtype
\17╔══════════════════════════════════════════════════════════════════════════════╗\1F
    \%H                  Page \%n              \17
╚══════════════════════════════════════════════════════════════════════════════╝\07
    Press:  PGDN for next page,   PGUP for prev page,  HOME for main menu.

end
    return

-scroll * Routine accepts key for scrolling help text
    %e = 0
    inkey %k
    if %k = KEY003         goto -opt0 |* Break key
    if %k = KEY01B %i = 0       | goto -line0    |* ESC    key
    if %k = KEY147 %i = 0       | goto -line0    |* Home key
    if %k = KEY149 %i = %i - 1 | cls | %F = line%i | goto -%F |* PgUp key
    if %k = KEY151 %i = %i + 1 | cls | %F = line%i | goto -%F |* PgDn key
    goto -scroll |* ignore any other key.

-line1405
-line099
-line0
    %e = 0
    cls begtype
\1F╔════════════════ BATDOC ═══════════════════╗\07       \17┌─────────────────────────┐\07
\1F║     Menu driven HELP and DOCUMENTATION.   ║\07       \17│ User supported software │\07
\1F╙───────────────────────────────────────────╜\07       \17│      by        │\07
                             \17│              │\07
    \4fGENERAL:\07                       \17│ Seaware Corp.        │\07
1.    Introduction and how to use this Help.         \17│ P.O. Box 1656       │\07
2.    The user supported concept.             \17│ Delray Beach, FL 33444  │\07
3.    BAT-BBS information. On-line users forum.    \17│ 305/392-2046          │\07
4.    What EBL is... an introduction!          \17│              │\07
5.    Version 3: The inside story!             \17│ Order your registered   │\07
                             \17│ copy for $49 from us      │\07
    \4fEXTENDED BATCH LANGUAGE Version 3\07           \17│ directly or our order    │\07
6.    Printing to display.                 \17│ line at 800/622-4070      │\07
7.    Reading data from users.             \17│ or 800/942-7317 in IL.  │\07
8.    Controlling program flow             \17│              │\07
9.    Using the keyboard stack.             \17│ Please copy and share   │\07
10.    Sensing program's results.                   \17│ BAT.COM, BATFUNC1.COM,  │\07
11.    Assignment statements.                 \17│ BATDOC.BAT, BATDEMO.BAT │\07
12.    Debugging aids.                  \17│ for non-commercial uses │\07
13.    Extended functions.                 \17│ only.           │\07
14.    Additional information.              \17└─────────────────────────┘\07

0.    Exit.

END

-entry0
    %o =
    read Enter the number of your selection. > %A
    if / = /%a    %a = 1
    if %a < 15 if %a > 1/ cls %F = opt%a | goto -%F
    if %a < :  if %a >  / cls %F = opt%a | goto -%F
    beep begtype
I DON'T KNOW THAT OPTION!
Just enter a number 0 to 14 and press the ─┘ key.

end
    goto -entry0

-opt0    cls begtype
Ready to leave on-line help! Press a key:

<\0FS\07>ystem    <\0FD\07>emo    <\0FH\07>elp
end
-exiting    inkey %a
        if %a = S    exit
        if %a = H    goto -line0
        if %a = D    stack BATDEMO | exit
        beep goto -exiting

-line100
-opt1    %h = INTRODUCTION | %i = 100 | call -header
    begtype
    This program will provide you with help information on the use of
the EXTENDED BATCH LANGUAGE version 3.0.  It is designed to allow for
easy access and retrieval of information that would be harder to find
by more conventional means.

    The information is broken up into multiple sections.  Each section
may have several pages.  To access each page in order, just keep
pressing the PGDN key.    At the top of your screen is the name of the
section which you are in and the page number.

\0FNote:\07

    If you wish to directly enter another section now, press the \0fHOME\07
key to return to the main menu, enter the proper \0fsection number\07 and
press the \0f─┘\07 key.

end
     goto -scroll
-line101 call -header | begtype
While in any of these sections, there are just three keys needed:

PGDN -    This key will advance to the next page of any section. If
    there are no more pages in the section, then it will advance
    to the next section.

PGUP -    This key will back up to a previous page within a section.
    If there are no more previous pages within a section, it
    will backup to the previous section.

HOME or ESC - Either of these keys will return directly to the
    main menu. From the menu, any section can be looked at
    directly by entering the section number and pressing ─┘.
end
    goto -scroll
-line199 %i = 102
-line102 call -header | begtype
  There are several sections where you will be given questions and answers.
If you would like to peek and see answer without specifically answering it,
you can press the space bar to reveal the answer letter by letter.

    One interesting facet you should know while using this on-line help
and documentation is that you are using the EXTENDED BATCH LANGUAGE
program to display and control these menus.

    Never before has a batch language been so powerful on the IBM
personal computer as to be able to provide a facility like this.  In
the following pages of description, we hope that you will see, as we
did, that this program has extraordinary capability which does much
more than just expand the capability of DOS.  In fact, it gives new
power to your system by providing capabilities never before possible.
end
    goto -scroll
-opt2
-line103 %i = 200
-line200 %H = "User Supported Concept" | call -header | begtype

 ╓─                                     ─╖
 ║      The license fee for Extended Batch Language is $49.          ║
 ║                                      ║
 ║ You are encouraged to copy and share BAT.COM, BATFUNC1.COM, BATDOC.BAT ║
 ║ and BATDEMO.BAT for non-commercial purposes only. You must not modify  ║
 ║ any of these files or make a profit from their distribution.       ║
 ║                                      ║
 ║ In appreciation of your support, you will be provided with many more   ║
 ║ powerful extensions to the language (including source code), examples, ║
 ║ and detailed documentation. All registered users can also access the   ║
 ║ BAT-BBS, a hot-line for assistance, tips, and updates.          ║
 ║                                      ║
 ╙─     (c) Copyright 1982, 1983, 1984, 1986 by Seaware Corp.         ─╜
              All rights reserved.

  Seaware Corp.                            305/392-2046
  Post Office Box 1656                           800/622-4070
  Delray Beach, FL 33444             (800/942-7317 in Illinois)
end
    goto -scroll
-line299 %i = 201
-line201 call -header | begtype
      For $49, you will be provided with a detailed users
guide.    This hardcopy manual has almost 400 pages of descriptions, examples,
useful utilities, and tips on this program's use.  You will also receive a
diskette containing the latest program version and useful utilities.  All
users are also invited to use the BAT-BBS, an on-line forum for user's
ideas, tips, programs, and assistance.    (See next section for more
information).  Our users have signed on thousands of times and testified
that this service has helped make Extended Batch Language one of their best
supported programs on their system.

    The concept of excellent user support is buried deep in our roots.    Much
of our philosophy was founded by Andrew Fugleman at Headlands Press, Inc.  I
would like to thank Andrew for his inspiration and help.  Because I feel
that good software should have someone standing behind it, we at Seaware
want to put your patronage directly into support for you as our thanks of
your support of us.  You will find it well worth it.


Seaware Corp. ≡≡≡≡ Post Office Box 1656 ≡≡≡≡ Delray Beach, FL 33444
end
     goto -scroll
-opt3
-line202 %i = 300
-line300 %H = "BAT - BBS" | call -header | begtype

\0eProvided to registered users only:\07

One of the special services we provide to EXTENDED BATCH LANGUAGE
users is through a communication medium called "BAT-BBS". This is
a direct link from you to other users, as well as Seaware.


The following list shows the many things that

    BAT-BBS can provide .  .  .

end
    goto -scroll
-line301 call -header | begtype
FOR USERS WITH A MODEM:

    * Receive program updates as soon as they are available!

    * BAT-BBS is a hotline for your questions!

    * Directly access our computer at Seaware via phone.

    * It will be ready to give helpful ideas.

    * Programs and Utilities are available to download.

    * Users are welcome to upload their programs/ideas.

    * Tips and techniques are on-line.

    * Converse with other users and program author via
        electronic mail.
end
    goto -scroll
-line302 call -header | begtype

IF YOU DON'T HAVE A MODEM:

    * You can still phone the BAT-BBS if you wish to
      have your questions answered via voice.  A
      recorder will take your message.
end
    goto -scroll
-line303 call -header | begtype

You can access the bulletin board service by using any 300 baud or 1200
baud modem with your computer.    You can use 8,N,1 or 7,E,1 protocols.

You will also need a communication program such as PC-TALK III, CROSSTALK,
QMODEM, or SmartCom.  Contact your local computer store if you need more
information or help with communication equipment or software.

Service is available 24 Hours a day.  Your personal password will be
supplied when you register.

end
goto -scroll
-line399 %i = 304
-line304 call -header | begtype
To access BAT-BBS by modem:

    1. Call the BAT-BBS phone number and wait about two rings then
       hang up.

    2. Call the BAT-BBS again, it will immediately answer the
       phone and wait for the carrier from your modem. The BAT-BBS
       is a "ring-back" system.

To access BAT-BBS by voice:

    1. Call the BAT-BBS phone number and wait about four rings.
       A recorder will take your question on the forth ring.

    2. You can take your time.  The recorder will continue as long
       as you are talking.    Be sure to leave your NAME and ADDRESS for
       a response.

The BAT-BBS phone number is 305/392-2046.
end
     goto -scroll
-opt4
-line305 %i = 400
-line400 %H = Introduction | call -header | begtype
    BAT is short for Extended Batch Language.  BAT is a powerful
productivity tool for the IBM Personal Computer.  It represents a
significant advance in providing a comprehensive yet easy to learn and use
facility for controlling tasks you give your computer.    It can even give
you on-line documentation SUCH AS THIS!

  BAT is a command programming language.  It is a high level language that
can be used as a direct replacement or in conjunction with DOS batch files.
It can operate with IBM DOS versions 2.0 through 3.x.    Compared with
standard DOS batch files, BAT has superior control structures, string
handling, and user interfaces.    It also has tracing facilities, and is easy
to learn and use.  Many aspects of the language are like BASIC.  Users of
VM/370 will also find it similar to EXEC2.  It seems that both "end users"
and programmers find BAT a simple and effective language.

end
    goto -scroll
-line401 call -header | begtype
With Extended Batch Language, you can have:

-    Better control of messages to the screen

-    Accept responses from the user and create responses to programs

-    String handling operations (substring, length, etc.)

-    Arithmetic expressions and assignments

-    Comparisons and program return codes

-    Search for files or tell if they exist

-    Complete freedom to mix DOS and BAT commands within the same control file


Let's look at how it measures up to today's DOS......
end
    goto -scroll
-line402 call -header | begtype
Function    DOS 1.1     DOS 2.0 or 3.0    Extended Batch Lang.
----------    -------     --------------    --------------------
BEEP                        X
CALL/RTN                    X
CLS                X        X
BEGSTACK                    X
BEGTYPE                     X
EXIT                X        X
GOTO                X        X
IF                Limited     X
INKEY                        X
READ                        X
READSCRN                    X
SKIP                        X
STATEOF             Limited     X
STACK                        X
TYPE        Limited     X        X
Assignments                    X
TRACE                        X
DOS Vars    X        X        X
Global Vars                    X
Return Codes            X        X
end
    goto -scroll
-line403 call -header | begtype
  As you can see from the previous chart, Extended Batch Language has more
power and enhanced capabilities than any version of DOS!.  This
program uses these capabilities to solve common problems for......

  The system programmer - who needs to do long sequences of tasks between
linker, compilers, debuggers, and editors.  He can now create an
intelligent link between these programs.  For instance, he may wish to do a
link depending on if the previous compile was successful.  He can also
respond automatically from a keyboard "stack" into various utilities.

  The secretary - who has several types of tasks to perform (word
processing, accounting packages, etc) and requires a simple way of changing
from one type of task to another, perhaps with optional help text.

  The student - who wishes to go from one game to another without having to
learn the system commands required to make each available.

  Testers - who wish to automate long, boring tests and procedures on the
personal computer. An excellent tool for a manufacturing line.
end
    goto -scroll
-line499 %i = 404
-line404 call -header | begtype

    The effect of using BAT is to put "covers" on the programs and system
that it controls.  In UNIX they call it shells, in VM they call it EXECs,
but to you it simply makes things friendly.  Described in these pages is a
solution to batch files through the use of Extended Batch Language.  A
friendly interface to you can now be easily created.

  Once you have looked over the descriptions of each command, browse
through the BATDEMO.BAT file and look at the commands in operation.  By
trying out some sample programs, you should be able to gain a full
understand of how to write some powerful batch files by using Extended
Batch Language.



Copyright (c) 1982, 1983, 1984, 1986 by Seaware Corp.  Program by
All Rights reserved by Seaware Corp.               Frank Canova

end
     goto -scroll
-opt5
-line405 %i = 500
-line500 %H = "Version 3: The inside story!" | call -header| begtype
We threw the book at it!  Almost everything you could possible have is now
in Extended Batch Language Version 3.  We took time in getting everyone's
suggestions into it, and used very little memory in doing it.  Here's some
of the highlights:

     *     Menus are  easy to create.  Just use the "Executive Menu
     Facility" to create customized menus the way YOU want to
     see  them.  This  automatic  procedure,  written in EBL,
     will create a    custom    menu  without ever having to know
     any  details  about  the  EBL    Language or batch  files.
     Using your PC couldn't be easier.

     *     Complete freedom with    all variables.    Strings can be up
     to 127 characters mixed  case, numbers to 19 digits.  If
     the built in  variables  aren't enough for you, you  can
     now have as many as you want!    Reserve from 0 to  64K of
     memory  for  "extended  variables"  that  can  have long
     descriptive names, do indexing, create arrays, and more.
     For floating point arithmetic?  Just load  the  optional
     float point math extensions!
end
    goto -scroll
-line501 call -header | begtype
     *     Extended functions give you  additional  power where you
     need    it.  Intended  for  programmers  needing  special
     capabilities,    several types of functions are available:
     DOS  support (CHDIR,  MKDIR,  REBOOT), low  level system
     support  (PEEK,  POKE,  INT86), string  support  (STRIP,
     LOWER, UPPER), math support (FLOAT, INT, FRAC), and MUCH
     more!

     *     Add your own functions to EBL.  If  you  have additional
     requirements for the EBL language,  you  can create them
     using    MASM,  C,  Pascal,  etc.  The    source    code  for
     Seaware's  extended functions (written  in Turbo Pascal)
     is provided as an example to registered users.

     *     Full support for many more environments like PC Network,
     TopView, Windows, DESQview and of course DOS 2 and DOS3.
     Also,    a  flexible  interrupt mechanism  was added  that
     makes EBL work with even more programs than ever before.
end
    goto -scroll
-line599 %i = 502
-line502 call -header | begtype
     *     File I/O is  easy within EBL Version 3. Use it to  setup
     printers,  keep  configuration  information,  initialize
     programs, or even create other batch files!

     *     Error recovery is now available  within batch files!  In
     cases where  an error    is  detected  while the EBL batch
     file  is  running,  you  can  now  include a  routine to
     recover gracefully from the problem.
end
     goto -scroll

-line503
-on.error-
    %e = %e + 1 | if %e > 2 then %L = ? | skip 4
    if %R <> 6 then skip 3
    %G = .goto.
    color 8f | type Loading part 2 ...
    batdoc2

begtype

     Unexpected error \%R in line \%L !

     This batch file was error free when it was distributed
     by Seaware. An error indicates that it was most likely
     modified by someone improperly. To get an updated demo
     diskette send $10 to Seaware directly or call 800/622-4070
     or 800/942-7317 in Illinois.


            Seaware Corp.
             Post Office Box 1656
            Delray Beach, FL 33444
end
%G =
%E = 0
exit